home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / nwsmkr21.zip / NWSMKR20.DOC < prev    next >
Text File  |  1991-12-31  |  8KB  |  184 lines
  1.  
  2.                                 NEWSMAKR v2.1
  3.  
  4.  
  5.      Written by:  Gregory R. Barton
  6.                   3334 NW 4th Street
  7.                   Gainesville, FL  32609
  8.  
  9.      SysOp:       Alachua County Computer Users Group BBS
  10.                   (904) 335-7289
  11.  
  12.                        -----------------------------
  13.  
  14.      Included within this ZIP file should be the following files:
  15.  
  16.             NWSMKR21.DOC          The file you're reading now.
  17.             NWSMKR21.EXE          The News Maker program.
  18.             MNEWSCFG.EXE          Program to customize the colors
  19.                                   in the MAKENEWS program.
  20.             MAKECFG.EXE           Program to remake the .CFG file in case
  21.                                   your old one gets corrupted.
  22.             NEWSV21.INP           Sample input NEWS file.
  23.             MAKENEWS.CFG          Default color scheme.
  24.             FILE_ID.DIZ           PCBoard 14.5a upload file description.
  25.  
  26.                         -----------------------------
  27.  
  28.      Operation:
  29.  
  30.      When you first get ready to run the NEWSMAKER program, you may want
  31.      to run the MNEWSCFG.EXE program to customize the colors you wish to
  32.      use and add your BBS name to the program.  Color input uses the new
  33.      PCBoard 14.5 '@Xnn' color codes for speed and ease of use.  The last
  34.      line to input is the name of your BBS.  If everything is correct, a
  35.      MAKENEWS.CFG file will be written with your customized configuration.
  36.  
  37.      The next step is to create a NEWS input file to colorize.  Included is
  38.      a sample, "NEWSV21.INP",  file so that you may see how one is written.
  39.      Using a standard ASCII text editor, create and save this file under the
  40.      name NEWS.IN (or whatever you'd like to name it).  The following control
  41.      codes are used:
  42.  
  43.           !S  - This stands for SUBJECT.  The text which follows on this 
  44.               line will be the subject headline and must be less than 30 
  45.               characters in length.
  46.  
  47.           !D  - This stands for DATE.  The text which follows on this line 
  48.               will be the date for display purposes and to help you keep 
  49.               track of how old a particular NEWS subject is.  Since this is
  50.               treated as ASCII text, you can use any date format you wish up
  51.               to a maximum of 30 characters.
  52.  
  53.           !T  - This stands for TEXT to follow.  All text after this control
  54.               code will be treated as the body of text for the news file.
  55.  
  56.           !#  - # is a number (1,2,3 or 4) which are color codes for HIGH-
  57.               LIGHTED text.  The text following one of these control codes
  58.               will be written in the color you have chosen for the high-
  59.               lighted text number.
  60.  
  61.        NOTE:  These control codes replace the "!H" control code in 
  62.               previous versions of NEWSMAKER (1.0 and 1.1).
  63.  
  64.           !N  - This stands for NORMAL text.  Use this to turn high-lighted
  65.               text off and revert back to normal text color.
  66.  
  67.      After you have created the NEWS input file, please make sure it is in
  68.      the proper format and save it.  Next run NWSMKR21.EXE as follows:
  69.  
  70.               NWSMKR21 input-file output-file   [RETURN]
  71.  
  72.      NEWSMAKER will take the input file, colorize and format it, and output
  73.      it to the NEWS output file you specified on the command line.
  74.  
  75.                         -----------------------------
  76.  
  77.      Error Messages:
  78.  
  79.      NEWSMAKER will respond with an error message IF:
  80.          1> The color configuration file, MAKENEWS.CFG, is not in the
  81.             current directory.
  82.          2> Incorrect command-line syntax is used.
  83.          3> The NEWS input file does not exist.
  84.      In each case, the appropriate error message will be displayed to alert
  85.      you to the problem.
  86.  
  87.                         -----------------------------
  88.  
  89.      Processing and Output:
  90.  
  91.      As NEWSMAKER is converting your input NEWS file to an output NEWS file
  92.      your monitor will display the current status.  At the top of the screen
  93.      will be displayed the input filename, output filename and NEWSMAKER
  94.      version number.
  95.  
  96.      Directly below the heading, the actual output NEWS file will be displayed
  97.      as it is processed, allowing you to see any errors that occur.
  98.  
  99.      Upon normal program completion, NEWSMAKER will confirm that the output
  100.      NEWS file was created and will report the number of lines processed in
  101.      the input file.  Pressing any key will return you to the operating system.
  102.  
  103.                         -----------------------------
  104.  
  105.      Additional File Viewer:
  106.  
  107.      Included in this package is a quick NEWS file viewer, SHOWNEWS.EXE.  To
  108.      use this file viewer, type:
  109.   
  110.               SHOWNEWS <output-file>
  111.  
  112.      where "output-file" is the file created with NWSMKR20.
  113.  
  114.      Additionally, this program will display any text file that has the
  115.      PCBoard 14.x "@X##" codes embedded in it.
  116.  
  117.      ---------------------------------------------------------------------
  118.  
  119.      * Please mail your $15.00 Donation or any comments to:
  120.  
  121.            Greg Barton
  122.            3334 NW 4th Street
  123.            Gainesville, FL  32609
  124.  
  125.            Phone:  (904) 372-4765
  126.            BBS (Alachua County Computer Users Group (ACCUG)):  (904) 335-7289
  127.  
  128.      Thank you for your support.
  129.  
  130.  
  131.      ---------------------------------------------------------------------
  132.  
  133.      Newsmaker History
  134.  
  135.      v1.0.  Original NEWSMAKER released.
  136.  
  137.      v1.1.  Added support for input file listing ("!F" control code) and 
  138.             support for NEWS files longer than 99 lines of text.
  139.  
  140.      v1.5.  Deleted the "!H" control code in favor of four new highlight
  141.             control codes.  These control codes can now be embedded in body
  142.             text and turned on or off at will.  Previous versions would only
  143.             let you have text of a different color all on one line.
  144.  
  145.      v1.6.  Fixed a bug where if an invalid control character followed a "!",
  146.             the program would hang the computer and force a three-fingered-
  147.             salute.
  148.  
  149.             NEWSMAKER correctly handles this problem now, passing the control
  150.             code straight through to the output file so you can see your 
  151.             mistake.
  152.  
  153.             Added the .DIZ file description for PCBoard 14.5a upload descript-
  154.             ions.
  155.  
  156.      v2.0.  Deleted the "!F" control code (used previously to specify the
  157.             output filename).  NEWSMAKER now accepts, and requires, the output
  158.             filename to be specified on the command line along with the input
  159.             filename.
  160.  
  161.             Reworked the output display to show the actual NEWS file output as
  162.             the input file was being processed.  Also included headings and
  163.             status lines for reporting functions.
  164.  
  165.             Reworked the parsing code in places to make it more tighter and
  166.             streamlined.
  167.  
  168.             Added error-checking on the command line to alert you to possible
  169.             problems such as missing color configuration files (MAKENEWS.CFG)
  170.             or missing input NEWS files.  Also checks to make sure that you
  171.             specify both an input and output filename.
  172.  
  173.      v2.1.  Upgraded the exist code in all included files from Turbo Pascal
  174.             v3.0 to Turbo Pascal v5.0.  All archived executable files are
  175.             now .EXE files which are both smaller in size and operate MUCH
  176.             faster.
  177.  
  178.             Also included the MAKECFG.EXE file which will recreate the
  179.             MAKENEWS.CFG file in case your original one became corrupted.
  180.  
  181.             Minor program embellishments have been done here and there for
  182.             the sake of the author.
  183.  
  184. End of History.